home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / msrch11.zip / DSZ.DOC < prev    next >
Text File  |  1996-07-07  |  6KB  |  130 lines
  1.  
  2.                     Documentation for MultiSearch Text Door
  3.                       Setting Up a DSZ Configuration File
  4.                          Written by Robert V. Chambers
  5.                                Copyright (c) 1996
  6.  
  7. If  you are running a one or two node board with standard comm ports you might
  8. not  need  to do any configuration in  order  to successfully run DSZ, GSZ, or
  9. FDSZ.  The  door is set up to run  a default parameter set that should work in
  10. most cases. The default command line for DSZ or GSZ is:
  11.  
  12. port <port num> handshake on sb <path to file>
  13.  |        |         |         |       |___ path to selected file
  14.  |        |         |         |___________ use YModem (or other protocol)
  15.  |        |         |_____________________ handshake on
  16.  |        |_______________________________ port number (from drop file)
  17.  |________________________________________ port command
  18.  
  19. FDSZ accepts a smaller list of commands. The default command line for FDSZ is:
  20.  
  21. <port num> sb <path to file>
  22.      |       |        |___________________ path to selected file
  23.      |       |____________________________ use YModem (or other protocol)
  24.      |____________________________________ port number (from drop file)
  25.  
  26. Note that the actual program name (ex: dsz) is supplied by the door along with
  27. these  default  command  lines. Remember you  selected  the program type using
  28. option 3 in MULTEDIT.EXE.
  29.  
  30. If  you are using non-standard port settings  or if you need to add additional
  31. parameters the defaults may not work for you.
  32.  
  33. If  this  is the case then you will  have to create DSZ.CFG using any Dos text
  34. editor.  This  file will let you fully  specify  most command line options you
  35. need  to  successfully  run DSZ, GSZ, or  FDSZ.  Create  this file in the same
  36. directory  as the other door files. If the  door does not detect that the file
  37. exists  it  will use the default  settings  described above. Otherwise it will
  38. read  DSZ.CFG  for  your  specified  parameters.  As  such  you  MUST  specify
  39. parameters for every comm port your system uses. DSZ.CFG will be read prior to
  40. each download.
  41.  
  42. The  door will assume that if DSZ.CFG  exists, then YOU are taking control and
  43. that  you will specify each and every comm port independently. It is essential
  44. that you fully describe each comm port you will be using. The door will detect
  45. the  port  that the user is using and  will use either the default settings or
  46. your settings, depending on whether or not DSZ.CFG exists.
  47.  
  48. Note that you cannot specify send commands (ex: sz) or pathnames that are part
  49. of the complete DSZ command line. This is taken care of internally by the door
  50. depending  on  the  selected protocol. DSZ.CFG  is  used  only to specify port
  51. information for each comm port.  Likewise you cannot specify any commands that
  52. might follow the send command.
  53.  
  54. The format for DSZ.CFG is:
  55. comm port number
  56. comm port parameters
  57.  
  58. You must have a two-line pair like this for each comm port you will be using.
  59.  
  60. If  you  are  specifying  non-standard comm  port  addresses  you MUST use the
  61. "portx"  DSZ command for DSZ or GSZ. If  you are unsure about this please read
  62. your  DSZ documentation. Here is an example of how to assign port 2 to address
  63. 2f8, interrupt 3:
  64.  
  65. 2 <-------------------------- port 2 (door will detect user's port)
  66. portx 2f8,3 ha on <---------- base address 2f8,IRQ 3  handshake on
  67.  
  68. (FDSZ  does  not  support portx. You typically  do  not  need a config file if
  69. running FDSZ.)
  70.  
  71. For standard comm ports you could specify:
  72.  
  73. 1 <--------------------------- port 1 (door will detect user's port)
  74. port 1 handshake both <------- port 1, handshake both
  75.  
  76. Again,  you will note that you do  NOT specify the program name, the protocol,
  77. or the path to the file. The door will do this.
  78.  
  79.  -----------------------------------------------------------------------------
  80.                                       NOTE
  81.         Only COM1 and COM2 are standard on all PC compatible computers.
  82.                 COM1 uses 3F8 and IRQ4.  COM2 used 2F8 and IRQ3.
  83.                   Multiple standards exist for COM3 and above.
  84.  -----------------------------------------------------------------------------
  85.  
  86.  DSZ COM3 uses 3E8 and IRQ4.  DSZ COM4 uses 2E8 and IRQ3.
  87.  DSZ COM7 uses 3E8 and IRQ5.  DSZ COM8 uses 2E8 and IRQ5.
  88.  
  89. If  you  wish  to use COM3 or COM4 and  your  computer  is not set up as shown
  90. above, you MUST use the "portx" command to specify the actual base address and
  91. interrupt vector.
  92.  
  93. Note  that  COM1 and COM3 use the same  IRQ.  You should not have two hardware
  94. devices  that  use  these  ports  at the  same  time  or  problems will almost
  95. certainly  arise, even if both devices are not active. The same applies to the
  96. COM2-COM4 pair. Please read the following excerpt from the DSZ documentation.
  97.  
  98. This is from the DSZ documentation file:
  99.  
  100.     "     ***********************************************************
  101.      Except as noted, all commands and options must be typed in lower case.
  102.                             DO NOT USE UPPER CASE!!
  103.                              Case is significant!
  104.           ***********************************************************
  105.  
  106.     Optional commands or arguments are shown in square brackets [].
  107.  
  108.     When  used (in any combination), the  A, CON, port, speed, handshake,
  109.     estimate, and d commands must be used in exactly this order.
  110.  
  111.     dsz  [A]  [CON]  [F] [port N] [speed  S]  [handshake XX] [pxN... ] [z
  112.     pxN... ] [D] [d] [restrict] [G] command
  113.  
  114.     Incorrectly  configured serial ports that work with programs that pig
  115.     out  both  IRQ3 and IRQ4 will lock up  with  DSZ. If DSZ locks up the
  116.     machine  as soon as it tries to send or receive data, this is usually
  117.     the  fault. Make sure the comm  port is strapped correctly; COM1 uses
  118.     IRQ4,  COM2  uses  IRQ3.  DSZ will lock  up  if  the comm port is not
  119.     properly set up.
  120.  
  121.     In  addition, DSZ will not work properly if two devices are connected
  122.     to  the same IRQ line, even when  some other programs (that don't use
  123.     interrupts as intensively) do work normally on the same machine. Make
  124.     sure  no other device uses the same IRQ as DSZ even if that device is
  125.     not active.
  126.  
  127.     COM3 and above are not widely standardized. If you have problems with
  128.     COM3 or COM4, chances are your "COM3" is non standard."
  129.  
  130.